Sessions - Create a session
This API creates a session within a webinar/meeting
Path Parameters
The meeting ID for which to create a session
Header Parameters
You need an app created on the JioEvents Platform and using the app credentials you can create a JWT to access this API. The JWT should have an issuer and the key "app" with the app id generated from the Platform.
The content type should be application/json
Request Body
Description of the session
descriptionMarkdown object
Markdown description configuration
Markdown text content
Type of message
Array of session invites
Topic/title of the session
Start time of the session in ISO format
End time of the session in ISO format
- 200
- 400
- 401
- 412
Success
Schema
Status message indicating the result of session creation
sessionDetails object
Detailed information about the created session
Unique identifier for the session
Topic/title of the session
Description of the session
descriptionMarkdown object
Markdown description configuration
Markdown text content
Type of message
Unique meeting ID for the session
ID of the parent webinar/meeting
Type of session
Start time of the session in ISO format
End time of the session in ISO format
Array of session invites
Current status of the session
Whether the session has been deleted
Creation timestamp
Last modification timestamp
Version number
Duration of the session in milliseconds
URL for joining the session
ID of the user who created the session
10-digit unique ID for the session
PIN for joining the session
advancedOptions object
Advanced configuration options for the session
Whether host audio is enabled
Whether participant audio is enabled
Whether host video is enabled
Whether participant video is enabled
Whether participants can join before the host
Whether waiting room is enabled
Whether only logged-in users can join
Whether only colleagues can join
Whether participants are hard muted for audio
Whether participants are hard muted for video
Whether the meeting is restricted
Whether classroom mode is enabled
Chat restriction level
{
"status": "Session created successfully.",
"sessionDetails": {
"_id": "se-eff13292-c342-4394-85a1-e64b42fadd2b",
"topic": "Session2",
"description": "",
"descriptionMarkdown": {
"text": "",
"messageType": "web"
},
"meetingId": "sm-0666ba1c-c585-4193-a329-2fc23bd29e72",
"parentMeetingId": "sm-ead69d8e-8c30-42f1-9798-8acfa5dd1277",
"type": "normal",
"startTime": "2025-08-21T14:30:00.000Z",
"endTime": "2025-08-21T15:00:00.000Z",
"invites": [],
"status": "active",
"isDeleted": false,
"cOn": "2025-08-20T21:38:13.546Z",
"mOn": "2025-08-20T21:38:13.546Z",
"__v": 0,
"scheduledDuration": 1800000,
"meetingUrl": "https://jioevents.com/shortener?meetingId=0161894358&pwd=dJy2y",
"userId": "u-5075a9a0-cfd0-4dd9-bca9-e441b0df9237",
"jiomeetId": "0161894358",
"pin": "dJy2y",
"advancedOptions": {
"hostAudio": false,
"participantAudio": true,
"hostVideo": false,
"participantVideo": true,
"joinBeforeHost": true,
"waitingRoom": false,
"loggedInOnly": false,
"colleagueOnly": false,
"participantHardAudioMute": false,
"participantHardVideoMute": false,
"isRestrictedMeeting": false,
"isClassroomMode": false,
"restrictChat": "NONE"
}
}
}
Example create session response
{
"status": "Session created successfully.",
"sessionDetails": {
"_id": "se-eff13292-c342-4394-85a1-e64b42fadd2b",
"topic": "Session2",
"description": "",
"descriptionMarkdown": {
"text": "",
"messageType": "web"
},
"meetingId": "sm-0666ba1c-c585-4193-a329-2fc23bd29e72",
"parentMeetingId": "sm-ead69d8e-8c30-42f1-9798-8acfa5dd1277",
"type": "normal",
"startTime": "2025-08-21T14:30:00.000Z",
"endTime": "2025-08-21T15:00:00.000Z",
"invites": [],
"status": "active",
"isDeleted": false,
"cOn": "2025-08-20T21:38:13.546Z",
"mOn": "2025-08-20T21:38:13.546Z",
"__v": 0,
"scheduledDuration": 1800000,
"meetingUrl": "https://jioevents.com/shortener?meetingId=0161894358&pwd=dJy2y",
"userId": "u-5075a9a0-cfd0-4dd9-bca9-e441b0df9237",
"jiomeetId": "0161894358",
"pin": "dJy2y",
"advancedOptions": {
"hostAudio": false,
"participantAudio": true,
"hostVideo": false,
"participantVideo": true,
"joinBeforeHost": true,
"waitingRoom": false,
"loggedInOnly": false,
"colleagueOnly": false,
"participantHardAudioMute": false,
"participantHardVideoMute": false,
"isRestrictedMeeting": false,
"isClassroomMode": false,
"restrictChat": "NONE"
}
}
}
Schema
Status Code of the API
The error code of the API
The error message of the API
{
"customCode": 0,
"message": "string",
"errors": "string"
}
Schema
Status Code of the API
The error code of the API
The error message of the API
{
"customCode": 0,
"message": "string",
"errors": "string"
}
Schema
Status Code of the API
The error code of the API
The errors array which includes objects with a "property" and "message" properties describing the error
{
"customCode": 0,
"message": "string",
"errorsArray": [
null
]
}